
PRODUCT UPDATE 

ATARI HOME COMPUTER SYSTEM 


Inside Front Cover. 

The codes listed ore 
BASIC Error Codes, 
and should be re- 
placed with 
Assembler Error 
Codes as shown 
(which are also listed 
in Appendix 1): 


Page vii. These are 
the correct page 
numbers for: 


ATARI' Assembler Editor User's Manual Update 

This product update contains o number of corrections and additions 
to the ATARI Assembler Editor User's Manual (C01 41 89-03 REV. 1). 

Error No. 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
128 
130 
132 

136 

137 

138 

139 

140 

142 

143 

144 

145 

146 
162 
165 


Insufficient memory 

No Start address for DEL command 

Mini-assembler address error 

LOAD file error 

Undefined label reference 

Error in syntax of Statement 

Label defined more than once 

Buffer overflow 

Missing label 

Value greater than 255 

Invalid null string 

Incorrect address or address type 
Phase error 

Undefined forward reference 
Line too large 

Unrecognizable source Statement 
Line number too large 
Misuse of LOMEM command 
No starting address 


Overflow in NUM or RENUM 

key pressed auring I/O Operation 
Nonexistent device 
Invalid command 
End of file 

Record longer than 256 characters 
Device does not respond 
Device does not return Acknowledge 
Signal 

Serial bus input framing error 
Serial bus data frame overrun 
Serial data checksum error 
Device done error • 

Read-after-write compare error 
Function not implemented 
Disk full 
Filename error 


How to Write Operands 

1 1 

FHex Operands 

11 

Immediate Operands 

11 

Page Zero Operands 

1 1 

Absolute Operands 

1 1 

Absolute Indexed Operands 

1 1 

Non-indexed Indirect Operands 

12 

Indexed Indirect Operands 

12 

Indirect Indexed Operands 

12 

Indexed Page Zero Operands 

12 

String Operands 

12 

REN Command 

16 

FIND Command 

16 


A 
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Page viii. In the Ap- 
pendices, the title for 
Appendix 9 should 
read: 


9 Using the Assembler Editor 
Cartridge to Best Advantage: 

Sample Programs 63 



Page 1 and Page 2. 


Delete reference to ATARI § 15 Dual Disk Drive. 


Page 5. The caption 
for Figure 2 should 
read: 


Figure 2. Memory map without use of LOMEM. 


Page 9. 


The example shown in Figure 4 is not an executable program. It is used only 
to demonstrate the format of a sample progrom. 


Page 11 . The third 
Paragraph should 
read: 


Please refer to the description of the LABEL = directive . . . 


Page 12. This Informa¬ 
tion pertains to In- 

direct Indexed 
Operands: 


Using indirect indexed operands will sometimes produce an error 12, although 
the source code appears to assemble correctly anyway. Use with caution; ex- 
amine the object code to be certain. 




Page 17. Under the 
REP Command, the 
first listing in the left 
column should read: 


REP/OLD/NEW/ 


Page 18. On the sam¬ 
ple Programming 
Form, the following 
line numbers are miss- 
ing : 


20 

30 

40 

50 

60 

70 

80 

90 


In Figure 7 on line 50, 
IMY should be: 


INY 


Page 19. This Informa¬ 
tion pertains to the 

LIST Command: 


The LIST command does not set the disploy flog, so a LIST containing control 
characters will execute those functions instead of printing the characters. 


The LIST Command for¬ 
mat should read: 





RETURN 



Page 20. The program 
should read as 
follows—nofe in par- 
ticular the indentation 
and spacing: 


EDIT 
LIST i 
10 * = $3000 
20 LDY #00 
30 REP LDX ABSX, Y 
40 BNE XEQ SAME PAGE 
50 INY TALLY 
60 JMP REP 
70 ABSX = $3744 
80 XEQ = *+$60 
90 .END 


EDIT 

LIST30 


RETURN 


30 REP LDX ABSX, Y 


EDIT 

LIST 60,80 


RETURN 


60 JMP REP 
70 ABSX = $3744 
80 XEQ = * +$60 

EDIT 


Page 22. The SAVE 
Command Example 

should look like this: 


Examples: SAVE#C: <1235,1 736 

SAVE#D2:MYFILE< 1235,1736 
SAVE#C9: <1235,1736 


To save an object program residing in hex address 1 to address2 on cassette 
or diskette, the commands are: 


SAVE#C: < addressl,address2 

CAUTION: Use the CSAVE procedure illustrated in your 410 Program 
Recorder Operator's Manual. 


SAVE#D:FILENAME < addressI ,address2 

where FILENAME is an arbitrary name you give to the block of 
memory that you are saving (where your object program is 
stored). 


SAVE#C9: <addressl ,address2 

Saves an object file without the DOS header bytes. This command 
procedure is used to generate tapes that can be booted on the 
cassette. You will have to supply your own cassette boof control 
information in your program. (See section 10 of Technical 
Reference Notes CAO 16555) 


Page 22. The LOAD 
Command Format 

should look like this: 


Form«: LOAD# { ) 


ASM [#D[n] : PROGNAME[.SRC]] 
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Page 25. In the general 
form diagram the upper 
left line should read: 

Add to Figure 8. 


In Figure 8, an additional line will appear at the end of the assembly, prior to 
the next EDIT prompt. The added line shows the number of errors in the 
assembly. 


Page 26. This Informa¬ 
tion pertains to where 
object program is to be 
stored: 


When generating tapes that can be booted on the cassette, do not assem- 
ble directly to the cassette using ASM,,#C9:. Store the object code in RAM 
and then use SAVE#C9: < address 1, address 2. 


Page 28. 


One more space should be added between the line numbers and pseudo ops 
on the top half of the page. 


In addition, one O 
should be deleted 
from the sixth line 
down so that it reads: 


100 .OPTNOOBJ 


Under Title 

and Page Directives, 

add the following note: 


The number of lines per page is set at 56 lines. To change the number of 
lines per page, change the content of location 480H. To cause an assembly 
listing to feed to top of page, change the location 481 Ff to a non-zero value. 


For example: 

bug m 

DEBUG 

C480<3C 

(this changes the number of lines in 


the printout to 60) 


Page 29. Under the 
Tab Directive, the 

following clause and 
table should be in- 
serted öfter the form 
of the directive (third 
Paragraph): 


The last two drawings 
at the bottom of the 
page, should be 
replaced by: 


—where each number corresponds to the number of columns to the right of the 
line number field to start printing. 

Number Field 


1 

2 

3 


op code 
operator 
comment 


3005 D064 40 BNE 


XEQ SAME PAGE 



3005 D064 

AME PAGE 


40 BNE XEQ S 

Ll 2-1 


L 


■ 17 —' 


-27— 1 


>G» 
mo 





200 .BYTE "AB. . . N" 



Page 30. Under BYTE, 
DBYTE and WORD 

Directives, the second 
line should read: 


In the third paragraph Appendix 5. 
of text under BYTE 
Directive, the last line 
should read: 


Page 31 . The first the sample program we used before. Statements 70 and 80 give. . . . 

paragraph of text 
under LABEL = DIREC¬ 
TIVE, the second line 
should read: 


Under LABEL = DIREC- 70 ABSX = $3744 
TIVE, lines 60 and 70 80 XEQ = ' +$60 

in the program should 
read: 


In the following given in Appendix 5. 

paragraph, the last 
line should read: 

This note belongs just Note: The assembler will always assign two-byte values to forward-referenced 

above * = Directive: labels. To use zero page addressing correctly, be certain that all zero page 

labels are defined ahead of time. 

Page 32. The fifth The effect of the directive is to reserve 36 locotions immediately. . . . 

paragraph of text, first 
line, should read: 


Under IF Directive, If the expression is not equal to zero, all of the code between lines 900 and 

the first paragraph of 990 will not be assembled. 

text, last sentence, 
should read: 


The SOURCE CODE 0100 ; CONDITIONAL ASSEMBLY EXAMPLE 

program should be 0120 Z =0 

rewritten as follows— 0130 *=$5000 

note in particular the 0140 LDA $45 

spacing requirements: 0150 - IF Z @ZNOTEQUAL0 

0160 TAX ;THIS CODE ASSEMBLED IF Z = 0 

0170 ZNOTEQUALO 

0180 . IF Z-l @ZNOTEQUALl 

0190 ASL A ; THIS CODE ASSEMBLED IF Z = 1 

0200 ZNOTEQUAL1 

0210 INX ; THIS CODE ALWAYS ASSEMBLED 



Page 33. Last line of 
the listing. 

Page 35. Under 
DEBUG COMMANDS, 

fifth line from the bot- 
tom, the command for 
Trace Operation 
should read: 

Page 36. The Informa¬ 
tion for the D or 
Dmmmm Display 
Memory command 
should read: 

The Example should 
be changed to read 
as follows: 


Page 37. 


In the following exam¬ 
ple, the fourth line 
should read: 


Page 38. The first 
sentence should read: 

Under Vmmmm 
Verify Memory, the 

first sentence should 
read: 


Page 40. The Example 

should be changed as 
shown—note in par- 
ticular the spacing re- 
quirements: 

This note should 
follow the Example: 

This Information per- 
tains to Gmmmm Go 
(Execute Program): 


An additional line will appear. The line will be the last line of each line of 
each assembly listing, and it will indicate the number of errors that were 
detected during the assembly. 

T or Tmmmm 


Dmmmm, yyyy where yyyy is less than or equal to mmmm shows the contents 
from mmmm to yyyy, inclusive, with address ''wraparound'' occurrinq at ad¬ 
dress $FFFF. 


DFFF0,3 

FFFO 

FFF8 

0000 


RETURN 


68 

40 

FF 

FF 

DD 

57 

B4 

E7 

00 

41 

41 

41 


FF FF FF FF 

77 E4 F3 E6 


The top sentence, beginning "This shows thot address 5000. . . should be 
deleted. 


5008 18 41 


54 41 52 49 


20 20 


The second command puts 31 and 87 in locations 700B and 700E. . . . 


Vmmmm <yyyy,zzzz compares memory yyyy to zzzz with. . . . 


5001 < 
5001 
< INY 
5004 


LDY $1234 rrarcra 

AC3412 Computer Responds. 

C8 Computer Responds. 


Note: Always leave a space after the < when specifying a mnemonic to be 
assembled under this command. 


A BRK (op code = $00) instruction will also stop the GO command. So even 
though the debugger does not support an explicit breakpoint facility, you can 
simulate this facility with a liftle extra work. 
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Page 41. This Informa¬ 
tion pertains to the 
TRACE Operation: 


When creating a program for tape that can be booted on the cassette, the 
execution of the program cannot be traced if the cassette boot control Infor¬ 
mation header has been included in the program. The program should be 
debugged before adding the header. 


Page 47. This defini- 
tion should immediate- 
ly follow the first 
Paragraph: 


’ The apostrophe indicates that the following character is to be translated into 
ASCII code. 


In the program line 
following the asterisk 
(*) definition, one 
space should be 
deleted between the 
number 50 and the 
word HERE so that it 
reads: 


50 HERE = * + 5 


In the last paragraph 
of text on the page, 
the first sentence 
should read: 


The asterisk also signifies multiplication (see Appendix 5). 


Page 49. In the last 
paragraph, left col- 
umn under the fable, 
the title should read: 


Z, PAGE X-Z, PAGE Y-ZERO PAGE INDEXED 


In the first paragraph 
in the right column, 
the title should read: 


ABS, X-ABS, Y-ABSOLUTE INDEXED 


In the last paragraph 
in the right column, 
the title should read: 


(IND), Y-INDIRECT INDEXED 


Page 51 . In the exam- 
ple at the bottom of 
the page, line 600 
should read: 


600 LDA #LABEL&$00FF 


Line 620 should read: 


620 LDA #LABEL /256 


.PAGE "MESSAGE" 




Page 53. In the first 
column, the third 
directive, should read: 


In the first column, the 
fifth directive, should 
read: 


In the first column, the 
seventh directive, 
should read: 


.BYTE a,b, . .. , n 


.DBYTE a, b.n 




The second directive 
from the bottom 
should read: 


assembles following code, up to LABEL, if only . . . . 


Page 60. 


The Notes at the bottom of the page refer to ATARI BASIC and do not pertain 
to Assembly language. 


Page 61 . These are 
additional ATARI 
PUBLICATIONS: 


ATARI Home Computer System Technical Reference Notes CA016555 Rev. A 
DOS II Utility Listings CO 1 7894 


Delete reference to: 


ATARI 815™ Operator's Manual CO 16377 


This is an addition to 
OTHER PUBLICA¬ 
TIONS: 


The Atari Assembler by Don and Kurt Inman, Reston Publishing Co., Reston, VA 


Page 63. The Appen¬ 
dix title should read: 


Using the Assembler Editor Cartridge 
To Best Advantage: 

Sample Programs 


Page 64. This Informa¬ 
tion pertains to using 
a Program Recorder to 
assemble a program: 


Do not assemble directly to tape (ASM, , #C:) except with very short programs. 
A longer program will result in a timeout error. Instead, assemble in memory 
(ASM) and save to tape (SAVE#C:<startadr,endadr). 




Page 65. The second 
sentence in the first 
Paragraph shouid 
read: 

And this is the pro¬ 
gram that follows: 


Then a new 
Paragraph Starts at: 

Page 67. Line 25010 
shouid read: 


Line 25020 shouid 
read: 

Pages 68-74. 


Page 69. The Informa¬ 
tion in lines 0250 and 
0260 is transposed; 
the lines shouid read: 


Page 70. The third line 
in Example 3 shouid 
read: 


If you have a cassette, type in the following program for loading from cassette 
tape: 


100 TRAP 300 

1 10 OPEN #1, 4, 0, "C:":REM open file on cassette for input 

120 GET #1, X:GET #1, X:REM throw away first two bytes 

130 GET#1, LOBYTE: GET#1, HIBYTE 

140 START = HIBYTE*256 + LOBYTE:REM starting address 

150 GET #1, LOBYTE: GET #1, HIBYTE 

160 FINISH = HIBYTE*256 +LOBYTE: REM ending address 

170 FOR ADDRESS = START TO FINISH 

180 GET #1, BYTE 

190 POKE ADDRESS, BYTE 

200 NEXT ADDRESS 

210 GOTO 130: REM check for further sections of code 
300 CLOSE #1 


When the machine language. . . . 


25010?J + 5;"E$('';A;'V';B;") = ”;CHR$(34); 


25020 FOR 1 = A TO B:?''|^|Sa";CHR$(PEEK(l + C));:NEXT I 


In the programs listed on page 68-74, the spacing is wrong, there shouid be 
only one space befween the third and fourth columns, one space between 
the fourth and fifth columns, and one space between the fifth and sixth col¬ 
umns. 

At the end of each listing, an additional line that indicated zero errors will ap- 
pear for each successful assembly. 


0250 PLA 

0260 STA ATTACK SET ATTACK TIME 

In line 0420, the O in #$BO shouid be a zero. 

In line 0470, the O in #$OE shouid be. a zero. 

30 ; ROUTINE SPLAY 

In line 0180, the last O in COLORO shouid be a zero. 
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Page 71 . Lines 0630 
and 0640 should 
read: 


630 ; 

640 ; BITS 3 AND 4 NOW GIVE THE COLOR TO USE 


Page 72. In Example 
4, lines 10 and 20 
should read: 


10 

20 


KATHY'S COLOR PALETTE 


Page 73. Line 400 
should read: 


0400 LOOP1 STA (POINTA),Y 


Page 74. In the first 8D0102 

line, 8D102 should 

be: 

In line 0910, 8D0AD0 8D1 ADO 
should be: 


Lines 0940 to 0970 
should read as 
folloWS: 


0666 

8D18D0 

0940 

STA 

COLPF2 


0669 

E6CF 

0950 

INC 

DECK 

NEXT DECK 

066B 

68 

0960 

PLA 


RESTORE ACCUMULATOR 

066C 

40 

0970 

RTI 


DONE 


Page 75. These com- 
mands, definitions, 
and page references 
should be added to 
the beginning of the 
QUICK REFERENCE list 
of EDITOR commands: 


DOS switches to DOS Menu, destroying current assembler RAM pro¬ 
gram in process, unless using DOS 2.OS with MEM.SAV (2 page 
reference in this manual) 

SIZE gives memory map buffer addresses for edit text buffer and user 

RAM (start of buffer, end of used area, end of available area) 6 

LOMEM bumps the Start address edit text buffer (your source program) up 
or down in memory 7 


The second to the last 
EDITOR command 
should read: 


SAVE #C: < xxxx, yyyy 


Page 77. Here is the 
corrected modification 
program: 


EDIT 



10 

*=600 


20 

LDA 

#$FF 

30 

STA 

$2441 

40 

STA 

$2448 

50 

STA 

$14BF 

60 

STA 

$14C0 

70 

.END 



At the end of the listing, an additional line that indicates zero errors will 
appear. 


C06I26I Rev. B 
©1982 ATARI, INC. 


